#オプション
#オプションの解決
オプションは、コンテキスト依存のルートを使用して上から下に解決されます。
#チャートレベルのオプション
- オプション
- オーバーライド[
config.type
】 - デフォルト
#データセットレベルのオプション
dataset.type
デフォルトはconfig.type
指定されていない場合は、
- データセット
- オプション.データセット[
dataset.type
】 - オプション
- オーバーライド[
config.type
].データセット[dataset.type
】 - デフォルト.データセット[
dataset.type
】 - デフォルト
#データセットのアニメーション オプション
- データセット.アニメーション
- オプション.データセット[
dataset.type
]。アニメーション - オプション.アニメーション
- オーバーライド[
config.type
].データセット[dataset.type
]。アニメーション - デフォルト.データセット[
dataset.type
]。アニメーション - デフォルトのアニメーション
#データセット要素レベルのオプション
各スコープは次のように検索されます。elementType
最初にオプション名の接頭辞を付けてから、接頭辞を付けません。例えば、エビード07-2b53-47e7-9326-295f8d7f2463ためにpoint
要素は次を使用して検索されますpointRadius
それがヒットしない場合は、radius
。
- データセット
- オプション.データセット[
dataset.type
】 - オプション.データセット[
dataset.type
].要素[elementType
】 - オプション.要素[
elementType
】 - オプション
- オーバーライド[
config.type
].データセット[dataset.type
】 - オーバーライド[
config.type
].データセット[dataset.type
].要素[elementType
】 - デフォルト.データセット[
dataset.type
】 - デフォルト.データセット[
dataset.type
].要素[elementType
】 - デフォルト.要素[
elementType
】 - デフォルト
#スケールオプション
- オプション.スケール
- オーバーライド[
config.type
].スケール - デフォルトのスケール
- デフォルトのスケール
#プラグインオプション
プラグインが提供できるのは、additionalOptionScopes
さらにオプションを検索するためのパスの配列。ルート スコープには、空の文字列を使用します。''
。ほとんどのコア プラグインは、ルート スコープからオプションも取得します。
- オプション.プラグイン[
plugin.id
】 - (オプション。[
...plugin.additionalOptionScopes
]) - オーバーライド[
config.type
].プラグイン[plugin.id
】 - デフォルト.プラグイン[
plugin.id
】 - (デフォルト。[
...plugin.additionalOptionScopes
])
#スクリプト可能なオプション
スクリプト可能なオプションは、基礎となるデータ値ごとに呼び出され、一意の引数を取る関数も受け入れます。context
コンテキスト情報を表す (「オプションコンテキスト)。
リゾルバーは 2 番目のパラメーターとして渡され、同じコンテキスト内の他のオプションにアクセスするために使用できます。
ノート
のcontext
関数はさまざまなコンテキストで呼び出すことができるため、スクリプト可能関数内で引数を検証する必要があります。のtype
フィールドは、この検証の適切な候補です。
例:
color: function(context) {
const index = context.dataIndex;
const value = context.dataset.data[index];
return value < 0 ? 'red' : // draw negative values in red
index % 2 ? 'blue' : // else, alternate values in blue and green
'green';
},
borderColor: function(context, options) {
const color = options.color; // resolve the value of another scriptable option: 'red', 'blue' or 'green'
return Chart.helpers.color(color).lighten(0.2);
}
#インデックス可能なオプション
インデックス可能なオプションは、各項目が同じインデックスの要素に対応する配列も受け入れます。データより項目が少ない場合、項目がループされることに注意してください。多くの場合、関数サポートされている場合は、より適切です。
例:
color: [
'red', // color for data at index 0
'blue', // color for data at index 1
'green', // color for data at index 2
'black', // color for data at index 3
//...
]
#オプションのコンテキスト
オプション コンテキストは、オプションを解決するときにコンテキスト情報を提供するために使用され、現在はのみに適用されます。スクリプト可能なオプション。 オブジェクトは保存されるため、呼び出し間で情報を保存したり渡したりするために使用できます。
コンテキスト オブジェクトには複数のレベルがあります。
chart
dataset
data
scale
tick
pointLabel
(ラジアルリニアスケールでのみ使用)
tooltip
各レベルはその親を継承し、親に保存されているコンテキスト情報は子を通じて利用できます。
コンテキスト オブジェクトには次のプロパティが含まれます。
#チャート
chart
: 関連するチャートtype
:'chart'
#データセット
に加えてチャート
active
: 要素がアクティブ (ホバーされている) の場合は truedataset
: インデックスのデータセットdatasetIndex
datasetIndex
: 現在のデータセットのインデックスindex
: と同じdatasetIndex
mode
: アップデートモードtype
:'dataset'
#データ
に加えてデータセット
active
: 要素がアクティブ (ホバーされている) の場合は truedataIndex
: 現在のデータのインデックスparsed
: 指定されたデータの解析されたデータ値dataIndex
とdatasetIndex
raw
: 指定されたデータの生データ値dataIndex
とdatasetIndex
element
: このデータの要素 (点、円弧、バーなど)index
: と同じdataIndex
type
:'data'
#規模
に加えてチャート
scale
: 関連するスケールtype
:'scale'
#カチカチ
に加えて規模
tick
: 関連するティックオブジェクトindex
: ティックインデックスtype
:'tick'
#ポイントラベル
に加えて規模
label
: 関連付けられたラベル値index
: ラベルインデックスtype
:'pointLabel'
#ツールチップ
に加えてチャート
tooltip
: ツールチップオブジェクトtooltipItems
: ツールチップが表示している項目